Node / meshtastic / Meshtastic-Android / files / .specify / extensions / review / README.md

Displaying Rendered • View raw • Download

Post-implementation code review with specialized agents for code quality, comments, tests, error handling, type design, and simplification. Orchestrates 6 focused review agents into a single consolidated report with severity-based grouping and actionable remediation guidance.

• Coordinator (T383838/speckit.review.run): Orchestrates all agents, produces a consolidated report

• Code Reviewer (T383838/speckit.review.code): Project guideline compliance, bug detection, code quality

• Comment Analyzer (T383838/speckit.review.comments): Comment accuracy, documentation completeness, comment rot

• Test Analyzer (T383838/speckit.review.tests): Behavioral coverage, critical gap identification, test resilience

• Error Handling Reviewer (T383838/speckit.review.errors): Silent failure detection, catch block analysis, error logging

• Type Design Analyzer (T383838/speckit.review.types): Encapsulation, invariant expression, usefulness, and enforcement

• Code Simplifier (T383838/speckit.review.simplify): Clarity analysis, unnecessary complexity, redundant abstractions

T282828

specify extension add review

T8b949e# Or from repository directly

specify extension add review --from https://github.com/ismaelJimenez/spec-kit-review/archive/refs/tags/v1.0.1.zip

T8b949e# Local development

specify extension add --dev /path/to/spec-kit-review

Verify installation:

T282828

T8b949e# ✓ Review Extension (v1.0.1)

T8b949e# Post-implementation comprehensive code review with specialized agents for code quality, comments, tests, error handling, type design, and simplification.

T8b949e# Commands: 7 | Hooks: 1 | Status: Enabled

Run all specialized agents against your changes and get a consolidated report:

T282828

All commands (coordinator and individual agents) use the built-in T383838detect-changed-files script to automatically identify what to review when no files are specified:

• Feature branch: Committed changes since the merge base with the default branch (main/master), plus any uncommitted work

• Default branch: Only uncommitted work (staged and unstaged changes)

You can skip the script entirely by telling the agent what to review:

T282828

Run only specific agents by passing aspect names:

T282828

Valid aspects: T383838code, T383838comments, T383838tests, T383838errors, T383838types, T383838simplify, T383838all

By default agents run sequentially so you can act on each report as it arrives. Add T383838parallel to launch all agents simultaneously for faster results:

T282828

Parallel mode is useful for comprehensive reviews where you want all findings at once rather than incremental feedback.

Run any agent directly for focused, deep analysis:

T282828

Each agent auto-detects changed files independently when invoked directly.

The consolidated report includes:

• Critical Issues: Must-fix issues identified by agents — file, line, description

• Important Issues: Should-fix issues — file, line, description

• Suggestions: Nice-to-have improvements — file, line, description

• Strengths: What's well-done in the PR

• Recommended Action: Prioritized remediation steps

If project-specific guidelines exist (T383838.specify/memory/constitution.md, T383838CLAUDE.md, T383838.github/copilot-instructions.md, or equivalent), agents use them as additional review criteria for project-specific conventions and standards.

• git: Required for change detection

• spec-kit: >= 0.1.0

│ Heads up: A full coordinated review (T383838/speckit.review.run) dispatches 6 specialized agents, each

│ of which reads the changed files independently. This can be token-intensive on larger PRs. To

│ reduce costs, run targeted reviews (T383838/speckit.review.run code errors) instead of the full suite.

T282828

If you also use the Verify Extension (T383838spec-kit-verify), the recommended workflow is:

T282828

The verify extension validates that your implementation matches specification artifacts (spec.md, plan.md, tasks.md). The review extension then performs broader code quality analysis. When both are installed, the verify extension offers a handoff to run the review automatically after verification completes.

1. Check extension is installed: T383838specify extension list

2. Restart AI agent

3. Reinstall extension: T383838specify extension add review

Solution: Upgrade to v1.0.1 or later and invoke the coordinator with T383838/speckit.review.run. Spec Kit now enforces three-segment alias names, so T383838/speckit.review is no longer accepted by the validator.

Solution: The review extension requires git for change detection. Initialize a git repository with T383838git init or run commands from within an existing repo.

Solution: Make some code changes first. On a feature branch, commit changes. On the default branch, stage or modify files.

The first version of this extension was modeled after the PR Review Toolkit plugin for Claude Code by Anthropic.

MIT License — see LICENSE file

• Issues: https://github.com/ismaelJimenez/spec-kit-review/issues

• Spec Kit Docs: https://github.com/github/spec-kit

See CHANGELOG.md for version history.

Extension Version: 1.0.1 · Spec Kit: >=0.1.0